Автоматически вызывает функции-члены по информации о типе для интерфейса. Вы можете описать интерфейс с помощью информации о типе и реализовать IDispatch::Invoke одним вызовом этой Displnvoke.

HRESULT Displnvoke
( 
void FAR* _this, 
ITypelnfo FAR* ptinfo, 
DISPID dispidMember, 
unsigned short wFlags, 
DISPPARAMS FAR*pparams, 
VARIANT FAR* pvarResult, 
EXCEPWFO pexeepinfo, 
unsigned int FAR* puArgErr 
);

Параметры
_this
Указатель на реализацию интерфейса IDispatch, которую описывает ptinfo.
ptinfo
Указатель на информацию о типе, описывающую интерфейс.
dispidMember
Задает вызываемый член. Для определения значения DISPID используйте GetlDsOfNames или документацию к объекту.
wFlags
Флаги, описывающие контекст вызова Invoke:

Значение	Описание
DISPATCH_METHOD	Член вызывается как метод. Если свойство имеет то же самое имя, то могут быть установлены и этот флаг, и флаг DISPATCH_PROPERTYGET.
DISPATCH_PROPERTYGET	Член считывается как свойство или элемент данных.
DISPATCH PROPERTYPUT	Член изменяется как свойство или элемент данных.
DISPATCH_PROPERTYPUTREF	Член изменяется путем присваивания ссылки, а не значения. Данный флаг допустим только тогда, когда свойство допускает ссылку на объект.

pparams
Указатель на структуру, содержащую массив аргументов, массив DISPID для именованных аргументов и счетчик элементов в массивах.
pvarResult
Указатель, по которому должен возвращаться результат, или NULL, если вызывающий не ожидает возврата результата. Если задано DISPATCH_PROPERTYPUT или DISPATCH_PROPERTYPUTREF, данный аргумент игнорируется.
pexcepmfo
Указатель на структуру, содержащую информацию об исключении. Если возвращается DISP_E_EXCEPTION, эта структура должна быть заполнена.
puArgErr
Индекс в rgvarg, соответствующий первому аргументу, который вызвал ошибку. Аргументы хранятся в pdispparams->rgvarg в обратном порядке, так что первому аргументу соответствует наибольший индекс массива. Значение параметра возвращается только в том случае, если код возврата равен DISP_E_TYPEMISMATCH или DISP_E_PARAMNOTFOUND.

Код возврата	Значение
S_OK	Успех.
DISP_E_BADPARAMCOUNT	Число аргументов в DISPPARAMS отличается от фактического числа аргументов метода или свойства.
DISP_E_BADVARTYPE	Один из аргументов в DISPPARAMS имеет неверный тип варианта.
DISP_E_EXCEPTION	Приложению необходимо возбудить исключение. В данном случае структура pexcepinfo должна быть заполнена.
DISP_E_MEMBERNOTFOUND	Запрошенный член не существует.
DISP_E_NONAMEDARGS	Данная реализация IDispatch не поддерживает именованные аргументы.
DISP_E_OVERFLOW	Один из аргументов в DISPPARAMS невозможно привести к заданному типу.
DISP_E_PARAMNOTFOUND	Один из DISPID параметров не соответствует ни одному из параметров метода. В данном случае puArgErr устанавливается на первый аргумент, вызвавший ошибку.
DISP_E_PARAMNOTOPTIONAL	Не задан обязательный параметр.
DISP_E_TYPEMISMATCH	Приведение типа для одного или нескольких аргументов невозможно. Индекс первого параметра в массиве rgvarg, имеющего неверный тип, возвращается в puArgErr.
E_INVALIDARG	Один из параметров неверен.
E_OUTOFMEMORY	Не хватает памяти для выполнения операции.
Другие	Могут также возвращаться любые коды возврата ITypeInfo::Invoke.

Комментарии
Параметр _this представляет собой указатель на реализацию интерфейса, к которому выполняется обращение. Displnvoke строит стековый фрейм, преобразует параметры по стандартным правилам приведения типов, помещает их в стек и затем вызывает соответствующую функцию-член в VTBL.

Пример
Следующий код из примера Lines (файл Lines.cpp) реализует IDispatch::Invoke с помощью Displnvoke. Эта функция использует m_bRaiseException для сигнализации о том, что во время вызова Displnvoke произошла ошибка.

STDMETHODIMP CLines::Invoke
(
DISPID dispidMember,
REFIID riid,
LCID Icid,
WORD wFlags,
DISPPARAMS FAR* pdispparams,	
VARIANT FAR* pvarResult,
EXCEPINFO FAR* pexcepinfo,
UINT FAR* puArgErr) 
{
return DispInvoke( this, m_ptinfo,dispidMember, wFlags, pdispparams,
pvarResult,  pexcepinfo,  puArgErr);   
}